
 
 F u n c t i o n :   a n n o u n c e ( s t r i n g O r E l e m e n t N o d e ,   b o o l D o N o t R e p e a t ) 
 
 
 
 D e s c r i p t i o n :   P e r f o r m s   a n   u n o b t r u s i v e   a n n o u n c e m e n t   f o r   s c r e e n   r e a d e r   u s e r s   u s i n g   a   s t r i n g   m e s s a g e   o r   t h e   t e x t u a l   c o n t e n t s   o f   a   D O M   e l e m e n t . 
 
 
 
 R e t u r n s :   S t r i n g ,   d o m E l e m e n t ,   o r   $ A   o b j e c t   i f   c h a i n e d . 
 
 
 
 N o t e :   D e s i g n e d   t o   f u n c t i o n   a u t o m a t i c a l l y   w i t h i n   s c r e e n   r e a d e r s   t h a t   p r o p e r l y   s u p p o r t   A R I A   l i v e   r e g i o n s .   T h e   a n n o u n c e   m e t h o d   i s   a l s o   p r o t o t y p e d   t o   t h e   S t r i n g   o b j e c t   f o r   a l t e r n a t i v e   u s a g e .   M e t h o d   s u p p o r t s   a u t o - q u e u i n g   f o r   r a p i d   s u c c e s s i o n   s u c h   a s   w i t h i n   l i v e   c h a t   a p p l i c a t i o n s .   U s e s   a r i a - l i v e = " p o l i t e "   t o   p r e v e n t   s p e e c h   i n t e r r u p t i o n   w h e n   q u e u e d . 
 
 
 
 E x a m p l e : 
 
 
 
 / /   B a s i c   a n n o u n c e m e n t   o f   t e x t u a l   c o n t e n t   w i t h i n   a   D O M   e l e m e n t . 
 
 v a r   m y E l e m e n t   =   $ A . a n n o u n c e ( d o m E l e m e n t ) ; 
 
 
 
 / /   A n n o u n c e   a   s t r i n g   m e s s a g e   w h i l e   s u p p r e s s i n g   r e p e a t   t e x t 
 
 v a r   s t r i n g V a r i a b l e   =   $ A . a n n o u n c e ( s t r i n g M e s s a g e ,   t r u e ) ; 
 
 
 
 / /   U s i n g   s t r i n g s 
 
 
 
 / /   B a s i c   a n n o u n c e m e n t   o f   a   s t r i n g   o b j e c t 
 
 v a r   s t r i n g V a r i a b l e   =   " D o w n l o a d i n g ,   p l e a s e   w a i t . " . a n n o u n c e ( ) ; 
 
 
 
 / /   A n n o u n c e   a   s t r i n g   o b j e c t   w h i l e   s u p p r e s s i n g   r e p e a t   t e x t 
 
 s t r i n g V a r i a b l e . a n n o u n c e ( t r u e ) ; 
 
 
 
 / /   M a n u a l l y   c l e a r   t h e   i n t e r n a l   m e s s a g e   q u e u e 
 
 
 
 $ A . a n n o u n c e . c l e a r ( ) ; 
 
 
 
 / /   O r 
 
 
 
 s t r i n g V a r i a b l e . a n n o u n c e . c l e a r ( ) ; 
 
 